home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / TELECOMM / PCPLA10 / PCPLA.DOC < prev    next >
Text File  |  1992-09-26  |  11KB  |  265 lines
  1.                                                 
  2.                                                 │  Procomm Plus Log Analyzer   │
  3.                                                 │  v1.0                        │
  4.                                                 │                              │
  5.                                                 │  Written by:  Don MacElrath  │
  6.  
  7.  
  8.  
  9.  
  10. Legal BS
  11. ────────
  12.  
  13. This software package is released under the FREEWARE concept.  I don't believe
  14. in SHAREWARE (or TRY BEFORE YOU BUY).  This package is fully functional.
  15. It may not be offered as an incentive towards the purchase of another product.
  16. It may not be distributed by any organization that requires a fee. 
  17. This program can be distributed as long as it is made available to everyone
  18. FREE OF CHARGE.  
  19.  
  20. Although I have tested & use this program personally, I will not be held
  21. responsible for any damages that may occur by use of this program.  
  22. I will also not be responsible for any misleading information that this
  23. program may provide.  Use this program at your own risk.
  24.  
  25.  
  26.  
  27.  
  28. Why PCPLA?
  29. ──────────
  30.  
  31. The purpose of this program is simple, to keep tack of the amount of time you
  32. spend on a BBS in a 1 month period.  It should help to reduce the 
  33. "PHONE BILL SHOCK" syndrome.  Although Procomm Plus keeps a log of all the
  34. boards that you call, it doesn't add up the total time you spend on each board.
  35. That is an extremely valuable bit of information.  
  36.  
  37. Suppose you are registered with the phone company and their SELECTIVE CALLING
  38. PLAN (or SCOPE).  Wouldn't it be nice to know if you were approaching your 20
  39. hour limit?
  40.  
  41. Or suppose you wanted to make "JUST 1 MORE LONG DISTANCE PHONE CALL".  
  42. Thinking to yourself that you really haven't made that many long distance
  43. calls this month, you decide to go for it.  This process does have a way
  44. of repeating itself.  Well, now you will know just how much time you spent
  45. calling out.  NO MORE EXCUSES WHEN YOU GET YOUR MONTHLY PHONE BILL!  *grin*
  46.  
  47. * SPECIAL NOTE ON THE SELECTIVE CALLING PLAN.
  48.  
  49. The Selective Calling Plan is not available in all states.  What it allows you
  50. to do is add a group of TOLL exchanges to your LOCAL calling area.  There is a
  51. monthly fee for this service (couple dollars, not much at all).  It will
  52. let you call those exchanges FREE OF CHARGE (There is a 20 hour limit per 
  53. month).  Check with your local telephone company and see if it is available
  54. in your area.  I know it is available in Southern NJ.                       
  55.  
  56.  
  57.  
  58.        
  59. Requirements
  60. ────────────
  61.  
  62. 1) A computer (yes, you do need a computer to run this software).
  63.  
  64. 2) Procomm Plus v2.01 or any version of Procomm Plus should work.
  65.    I don't think DataStorm changed the format of the PCPLUS.FON file
  66.    when they updated PCPLUS.  If you have an older version of PCPLUS
  67.    and this program doesn't work, I guess I was wrong.
  68.    * This program will also work with any communications package that
  69.    uses the PCPLUS.FON format.  See the section about PCPLUS.FON.
  70.  
  71.  
  72. Optional Equipment (For PEAK Performance)
  73.  
  74. 1) 5 Gigabillion Megabyte Hard Drive. 
  75.  
  76. 2) 1,423 Megs of RAM.
  77.  
  78. 3) ZZGA Video Support.
  79.  
  80. 4) 7 High Density Floppy Drives (required for the Install).
  81.  
  82. 5) Asprin and/or Beer.
  83.  
  84.  
  85.  
  86.  
  87. Getting Started
  88. ─────────────── 
  89.  
  90. 1)  Place each of the files in your Procomm Plus Directory.
  91.     NOTE:  you can use whatever directory you like, but the 2 files
  92.     PCPLA.EXE and PCPLA.CFG must be in the same directory!    
  93.  
  94.  
  95. 2)  Type:  PCPLA /SETUP  <ENTER>
  96.     Just answer the questions and you're all set.  Enjoy!
  97.     
  98.     NOTE: The file PCPLUS.FON is a file that is generated by Procomm Plus
  99.     and contains all the information that PCPLA needs.  This file should
  100.     be in your Procomm Plus directory.  I don't think you can change its
  101.     location or turn the logging process off from within the PCPLUS setup
  102.     utility.  IT SHOULD BE THERE!
  103.  
  104.  
  105.  
  106.  
  107. PCPLA Setup Help
  108. ────────────────
  109.  
  110. Name and Location of the PCPLUS.FON file.
  111.  
  112. This is the log file that Procomm Plus generates each time you log on and off
  113. a bulletin board.  This file is usually in your PCPLUS directory and is called
  114. PCPLUS.FON.
  115.  
  116. Select Output.
  117.  
  118. You have a choice to send the results of PCPLA to the screen or to a text file.
  119. If you choose to send the info to a file, you will be prompted for the output
  120. location and filename.
  121.  
  122.  
  123.  
  124.  
  125. PCPLA Output Explanation
  126. ────────────────────────
  127.  
  128. There isn't really much to explain.  It should be self explanatory.  The only
  129. thing that I would like to point out here is the 2 time columns.  One is labeled
  130. ELAPSED and the other is labeled FIX.
  131.         
  132.       ELAPSED 1:  This is the actual time that you spent on a BBS.
  133.                   This field contains hours, minutes and seconds.
  134.                   
  135.       ELAPSED 2:  Since the phone company charges by minutes and not
  136.                   seconds, the ELAPSED 1 field isn't very useful.
  137.                   If you called a board and spent 25 seconds on it,
  138.                   the phone company will charge you for a full minute!
  139.                   This field takes that into consideration and rounds    
  140.                   the results.  The time is displayed in hour:minutes.
  141.                   
  142. There can be a large difference between the 2 ELAPSED fields.
  143. It isn't uncommon for me to get results that vary by as much as an hour!
  144. All those seconds rounded up to the next minute really add up!         
  145.  
  146. NOTE:  I DON"T HAVE A CLUE AS TO HOW THE PHONE COMPANY GETS THEIR INFORMATION.
  147.        No matter how much I try to keep track of my calls, the phone company
  148.        seems to always have some unique figures on my phone bill.  At least
  149.        this program should give you a ballpark idea on your phone calls.
  150.        Much better than actual guesswork (or figuring it out by hand!).
  151.  
  152.  
  153.  
  154.  
  155. Invalid PCPLUS.FON Entries
  156. ──────────────────────────
  157.  
  158. There will be times while you are ONLINE and your computer locks up (or some 
  159. other odd thing happens like a power failure).  This will leave blanks in
  160. the PCPLUS.FON file in the ELAPSED & OFFLINE fields (see the example .FON file
  161. below).  Since there is no way to determine the actual time you spent on the
  162. board, these entries are skipped.  All of the invalid entries will be displayed
  163. to you at the end of the program.  That information could be important,
  164. especially if you have 10 invalid entries to 1 long distance board.  That's at
  165. least an additional 10 minutes of LONG DISTANCE calling!
  166.  
  167.  
  168.  
  169.  
  170.  
  171. Sample PCPLUS.FON File
  172. ──────────────────────
  173.  
  174. NAME                                NUMBER    DATE    ONLINE  OFFLINE  ELAPSED
  175. Bogus Board                  ?-???-???-???? 09/24/92 19:39:09 19:42:13 00:03:04
  176. Just Another Board                 ???-???? 09/24/92 20:31:11                  
  177. Just Another Board                 ???-???? 09/24/92 21:08:02 21:09:47 00:01:45
  178. The Bar                            ???-???? 09/24/92 21:11:14 21:12:31 00:01:17
  179. John Doe's BBS                     ???-???? 09/24/92 22:45:18 22:45:43 00:00:25
  180. Computer BBS                       ???-???? 09/24/92 22:58:54 23:09:42 00:10:48
  181. Bogus Board                  ?-???-???-???? 09/24/92 23:21:31 23:24:57 00:03:26
  182. John Doe's BBS                     ???-???? 09/24/92 23:26:16 23:27:51 00:01:35
  183. John Doe's BBS                     ???-???? 09/24/92 23:28:17 23:43:08 00:14:51
  184. John Doe's BBS                     ???-???? 09/24/92 23:46:17 23:48:49 00:02:32
  185.  
  186. NOTE ENTRY #2.  This is an example of an invalid entry.  This could have been
  187. caused by the user rebooting while online, or perhaps there was a power
  188. failure.  Obviously, it isn't good to have this kind of entry.  Shit happens.
  189.  
  190. If your communication package outputs a file similar to the one above, then
  191. you should be able to use this package.  Just change the info in the first
  192. question when you run SETUP.
  193.  
  194.  
  195.  
  196.  
  197. Miscellaneous Stuff
  198. ───────────────────
  199.  
  200. The large your PCPLUS.FON file is, the longer it will take to process.
  201. You might want to consider deleting the PCPLUS.FON file at the beginning
  202. of every fourth month or so.
  203.  
  204. When entering a date to calculate, you must provide a number that is 5
  205. characters in length.  1/92 is not acceptable, 01/92 is the proper format.
  206.  
  207. If you have a habit of changing the board names (or the phone numbers),
  208. they will are appear as separate entries in the PCPLA output.
  209. For Example, lets say 1 entry in your dialing directory is JOE'S PLACE,
  210. but you realize that the actual bbs name is JOE'S BBS.  Naturally you change
  211. it.  The PCPLA output will show both names!  When you change the name in the
  212. PCPLUS dialing directory, the DIALING DIRECTORY gets updated, not the
  213. PCPLUS.FON file!  Remember that.  That's why the output shows the BBS name
  214. and Phone number - to clear up any doubts as to why there might be 2 entries
  215. for the same bbs.
  216.  
  217. If you choose to output a text file, the length of each line of text will
  218. be over 80 characters.  So, if you want to print this file you should set
  219. your printer up in landscape mode (or 132 column mode).  See your printer
  220. manual for instuctions on LANSCAPE printing.  See your DOS manual for 
  221. instructions on printing a DOS TEXT FILE (look under the TYPE command).
  222.  
  223. If enough people like this program - LET ME KNOW! (see below).  I would be 
  224. happy to make changes or improvements in it and release another version.
  225. I could even be persuaded to include other communication packages.  *grin*
  226.  
  227.  
  228.  
  229.  
  230. Tired 
  231. ─────
  232.  
  233. I'm getting tired now.  I'm sure I have overlooked some things, but a little 
  234. common sense should help you get through whatever problems you might have.
  235.  
  236. I can be reached via ILINK in the Procomm Plus conference.  Or which ever
  237. conference might be more appropriate.  We don't want to upset the conference
  238. moderators.  (Be careful when you spell my name or I won't get the message).
  239.  
  240.  
  241.  
  242.  
  243. History
  244. ───────
  245.  
  246. 9/92    -  Initial release of PCPLA (v1.0)
  247.            Cleaned up the program & made some quick docs so that the 
  248.            public could benefit from using it.
  249.            Praying that no one gets a runtime error or finds a bug! :)
  250.  
  251.  
  252.  
  253.  
  254. Last Words (I promise!)
  255. ───────────────────────
  256.  
  257. Consider becoming a member of an Environmentally Aware Organization, such
  258. as Green Peace.  We all have to live on this planet and I would prefer
  259. to live in a clean environment.  Thanks.
  260.  
  261.  
  262.                                Happy Modeming!
  263.  
  264.                                                               - Don MacElrath
  265.